home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / FCOMBINE.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  42 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _FCombine(cFileName, cInsFileName, nInsByte ) --> nBytesWritten
  8.  
  9. PARAMETERS:
  10.  
  11. cFileName    : File name to insert cInsFileName into
  12. cInsFileName : File to be inserted into cFileName at nInsByte
  13. nInsByte     : Byte number at which to begin insertion
  14.  
  15. SHORT:
  16.  
  17. Comine two files by inserting one into the other at a specified byte.
  18.  
  19. DESCRIPTION:
  20.  
  21. _FCombine() combines two files by inserting one into the other at a specific
  22. byte.
  23.  
  24. nInsByte will typically be derived from some other process which has opened
  25. the first file and determined where it needs to insert the second file.
  26.  
  27. It is handy for finding and replacing tokens in text or binary files with the
  28. contents of other files.
  29.  
  30. NOTE:
  31.  
  32.  
  33.  
  34. EXAMPLE:
  35.  
  36. _FCombine('FILE1.TXT','FILE2.TXT',4290)
  37.  
  38. Result: FILE2.TXT is inserted into FILE1.TXT at byte offset 4290, (from
  39. beginning of file).
  40.  
  41. ******************************************************************************/
  42.